phpArticle 2.0 模板使用說明
本說明製作於: 2003-04-17

  • 每一套風格都會配套一套變量與一套模板.
  • 如 default 風格,默認是配套 default 變量套系和 default 模板套系.

變量

變量或數組 --- 以美元符號 $ 開頭的字符串,模板中的變量均有其意義,輸出時會被有意義的內容所替換.

變量可以由模板轉換成,或由程序從變量套系中即出數據並動太動態生成,稍後會說明如何生成.

常用的變量或數組
以下變量由模板轉換而成,不同的變量對應著不同的模板.修改相應的模板即可以得到你需要的界面

變量 模板 應用的面頁 說明備註
$header header 全部(除打印頁面) 為頁眉,頁眉中主要是放一些常用的鏈接,LOGO,你也可以修改 header 模板,以迎合你自己網站的風格.
$footer footer 全部 為頁腳,放版權信息等,你也可以放上你需要的常用鏈接.
$headinclude headinclude 全部 該模板是放一些CSS層疊樣式表,及一些放在<head>與</head>之間的代碼.如:javascript腳本.
$style / 全部 該變量為數組,主要是替換頁面的顏色,顏色包括表格的背景色,字體顏色等,表格寬度,還有<body>標記等,該變量由程序動態生成.來源於後台的變量套系統.

 

由變量套系中動態生成變量.
變量套系中的變量將會動態的生成數組 $style[] .
具體如下:
進行以下操作: 進入後台->變量管理->編輯變量
再點選其中一個變量套系,將看到變量套系裡的變量列表.
點擊查看該圖


如 body 變量,點擊對應的"編輯"鏈接,將進入變量編輯頁面,如圖:



在上圖可以看到變量 body 與它將會被替換為 <body> , 代表的意義就是 會生成一個變量 $style[body] 而該變量在模板中將會被替換為 <body> . 其它的也是一樣.該變量在所有模板中都會有效 . 只要在模板中放和 $style[body] 都會在輸出時自動替換為 <body> . 而其它的變量也是一樣.還有一點要注意,就是每個變量都是對應一套變量套系.而模板也是對應著一套模板套系.而變量套系跟模板套系都會對應著風格. 即是 該變量要對應著相應的模板套系中的模板才會起到它的作用.關係如下圖

提示: 你可以添加自定義變量,如變量名為 abc 將生成變量 $style[abc] ,把 $style[abc] 放到模板中將可以替換 abc 變量中的實際內容.
例:

變量 替換為
logo <img src="http://www.21ds.net/images/logo.gif">

添加這樣的變量,內容如上表. 將生成 $style[logo] 變量,如果把該變量放到 header 模板中,將會在每個頁面的頁眉中顯示




模板

頁面一般由三個主要模板組成.header,headinclude,footer 具體每個模板的用途上面已經說明了.
所以我們要定義文章系統的界面一般只要修改這三個模板就可以.


風格管理->編輯風格->選擇要修改的風格

將可以看到上面的風格修改頁面.這裡可以修改 head,headinclude,footer 這幾個模板及常用的變量設置,即頁面大小,表格寬度,顏色等的設置.具體修改就要看你的發揮了.


常見問題

  1. 怎麼才知道每個頁面使用了哪些模板?
  2. 文章系統快速搜索的代碼應該如何寫?
  3. 如果在不同的分類使用不同的風格?


怎麼才知道我需要修改哪些頁面?
步驟如下:
系統設置->基本設置->模板設置->是否顯示模板註釋?

把這項設置為"是".

再返回文章系統的首頁,刷新一次.再按右鍵查看源文件.如圖:



在源代碼中你將可以看到類似下面的註釋:

<!-- BEGIN TEMPLATE: home -->
.
.
.
<!-- BEGIN TEMPLATE: headinclude -->
.
.
.
<!-- END TEMPLATE: headinclude -->
.
.
.
<!-- BEGIN TEMPLATE: footer -->
.
.
.
<!-- END TEMPLATE: footer -->

.
.
.
<!-- END TEMPLATE: home -->

中間的 "." 為省略的部分.從上面可以看到有六個註釋,這裡只是舉例,當然不一定是這個數目.可以看出每個註釋都代表著它的意義.
第一個<!-- BEGIN TEMPLATE: home -->對應著最後一個<!-- END TEMPLATE: home -->

註釋是成對出現的.意義是這樣的

<!-- 開始模板/結束模板 模板名 -->
<!-- BEGIN TEMPLATE: home -->
<!-- END TEMPLATE: home -->

從這個表應該可以看出這些註釋標記的意義了吧.
這個頁面是由 home 模板和 headinclude ,footer 等模板組成.從源代碼可以知道這個頁面由哪些模板組成,而這裡顯示的結構是 home 模板中包含著 headinclude,footer 等模板.即是模板中可以嵌套模板.即然知道了頁面由哪些模板組成及模板的結構,相信剩下修改面頁的工作就不會難到你了.你可以方便的使用後台的模板搜索功能找到要修改的模板.這裡你只要注意模板的結構就可以修改了.如果修改錯了,可以在編輯模板點擊查看默認模板來看未修改前的代碼,也可以點恢復鏈接把模板恢復為默認的.


文章系統快速搜索的代碼如下:

<form method="post" action="$phparticleurl/search.php">
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<input type="text" name="keyword" size="30" maxlength="20">
<select name="type">
<option value="all" selected>搜索整篇文章</option>
<option value="title">只搜索標題</option>
</select>
<input type="hidden" name="ordertype" value="date">
<input type="hidden" name="action" value="result">
<input type="submit" value="提交">
</td>
</tr>
</table>
</form>

你可以任意的把上面的代碼放到任一個模板中.如果不是放到模板中,請先把上面的 $phparticleurl 替換成有效的路徑.路徑指向 文章系統的 search.php



如何在不同的分類使用不同的風格?

文章系統支持多個風格的同時使用.使用方法如下.

進入台後,把自帶的風格設置為默認.再新建一個風格,連原來自帶的默認風格,共兩個風格.當然還可以添加更多的風格.
你現在可以修改新建的風格.再設置不同的分類使用不同的風格.這樣每個分類就擁有不同的界面了.而其它頁面將會使用剛才你設置為默認的那風格的界面.

例:
現在我們的文章系統共有三個分類,分類命名為分類一,分類二,分類三.不必理會這些分類是根分類還是哪個分類的子分類.因為風格的設置是不會繼承到子分類的.剛才所添加的分類都是使用默認風格的,因為你只有一個風格.現在再新建一個風格,命名為 style2 而原來的默認風格命為 default ,現在我們設置分類二的屬性.如下圖





設置分類二的風格為 style2 ,剩下就是修改這個風格.進入風格列表找到 style2 這個風格, 如下圖:



點擊 style2 的編輯鏈接進入編輯面頁.




在這裡你可以隨意定義你的 style2 的界面.而定義出的效果將會應用到使用這個風格的分類中,如果你把這個風格設置為默認,還會應用到其它面頁中.

如果你覺得這些還不夠定義你的界面,那你還可以修改這個風格所配套的模板及變量,具體可以點擊屬性鏈接進入屬性面頁.



在屬性設置面頁中你可以看到這個風格所配套的變量套系與模板套系,在這裡也可以修改風格所配套的變量套系與模板套系.只要你修改這個風格所配套的變量套系中的變量與模板套中的模板,就可以定義更多的界面.具體要修改哪些模板,剛才已經說過了,請看:"怎麼才知道每個頁面使用了哪些模板?".


如果你覺得哪裡有說得不夠的或看不懂的,或有什麼建議的.請到技術支持論壇中發問.
論壇地址: http://www.21ds.net/forum